home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / os2 / mdf121.arj / MDF_ITA.DOC < prev    next >
Text File  |  1994-06-12  |  12KB  |  421 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                   MDIFF  -  MPATCH
  14.  
  15.                                     Release  1.21
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.           Un software semplice ma completo per produrre e applicare patch a
  27.                               programmi e file di dati.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                              Manuale in lingua italiana.
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                (C) 1994/95 Maurizio Giunti - Tutti i diritti riservati
  50.  
  51.  
  52.  
  53.  
  54.  
  55.          1.INDICE
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.          1.INDICE .......................................2
  64.  
  65.          2.PERCHE' ......................................3
  66.  
  67.          3.A COSA SERVE .................................3
  68.  
  69.          4.DOS E OS/2 ...................................3
  70.  
  71.          5.LIMITI .......................................3
  72.  
  73.          6.MDIFF - MDIFF2 ...............................4
  74.  
  75.          7.MPATCH - MPATCH2 .............................4
  76.  
  77.          8.ALCUNI CONSIGLI ..............................5
  78.  
  79.          9.DIRITTI ......................................5
  80.  
  81.          10.GARANZIE ....................................5
  82.  
  83.          11.LIBRERIE DI CLASSI C++ ......................6
  84.  
  85.          12.COME REGISTRARSI ............................6
  86.  
  87.          13.RINGRAZIAMENTI ..............................7
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 2 -
  112.  
  113.  
  114.  
  115.  
  116.  
  117.          2.PERCHE'
  118.  
  119.          Qualche tempo fa dovevo rilasciare una versione  aggiornata di un
  120.          mio programma:  il  pacchetto  compresso  "pesava"  piu'  di  200
  121.          Kbytes, e sarebbe  stato sicuramente  piu' conveniente per  tutti
  122.          aggiornare il vecchio eseguibile tramite  una patch.  Mi  misi in
  123.          caccia di un software che mi permettesse di  creare e distribuire
  124.          patch dei miei programmi  per Dos e OS/2:  per Dos ne  ho trovati
  125.          alcuni (ma non  mi hanno soddisfatto  per vari motivi),  per OS/2
  126.          neanche uno ! Ho quindi deciso  di farmene uno e....eccolo  qui !
  127.          8-)
  128.  
  129.  
  130.  
  131.          3.A COSA SERVE
  132.  
  133.          MDIFF crea un file binario di differenza tra due file. Con MPATCH
  134.          e il vecchio  file si puo'  ricreare il  nuovo file partendo  dal
  135.          file di differenza. Cosa c'e' di buono in tutto  cio' ? Semplice:
  136.          supponendo che il  file di  differenza sia piu'  breve del  nuovo
  137.          file, e' piu' conveniente distribuire solo quello invece di tutto
  138.          il file, soprattutto se la distribuzione avviene via modem.
  139.  
  140.  
  141.  
  142.          4.DOS E OS/2
  143.  
  144.          Nel  pacchetto   di   distribuzione   troverete   quattro   files
  145.          eseguibili, due per  Dos e  due per  OS/2 2.xx.  Non c'e'  alcuna
  146.          differenza nella  funzione  e  nell'uso  dei  programmi  sui  due
  147.          sistemi operativi.  I  files *.MDF  prodotti  con MDIFF  per  Dos
  148.          possono essere utilizzati con MPATCH per OS/2 e viceversa.
  149.  
  150.  
  151.  
  152.          5.LIMITI
  153.  
  154.          MDIFF non puo' trattare files piu' ampi di  16 Megabytes. Inoltre
  155.          la versione Dos di MDIFF non puo' trattare files  piu' ampi della
  156.          memoria convenzionale disponibile  sul sistema. La  versione OS/2
  157.          di MDIFF,  grazie alla  gestione della  memoria  di tale  sistema
  158.          operativo, non presenta questa limitazione.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 3 -
  174.  
  175.  
  176.  
  177.  
  178.  
  179.          6.MDIFF - MDIFF2
  180.  
  181.          Il programma  MDIFF  si  occupa  di  comparare  due  files  e  di
  182.          immagazzinare le differenze  tra di  essi in un  terzo file  che,
  183.          generalmente, e' molto piu' compatto. Vediamo come si usa:
  184.  
  185.            MDIFF [-C<c>] [-R<r>] [-F] [-S] <OldFile> <NewFile> [<MDFfile>]
  186.  
  187.          <OldFile> ovviamente  e' il  nome della  versione precedente  del
  188.          file da comparare,  mentre <NewFile>  e' il  nome della  versione
  189.          attuale. Se necessario  si puo' specificare  il nome del  file di
  190.          differenza da creare <MDFfile>, altrimenti MDIFF crea un file che
  191.          ha lo stesso nome di <NewFile> ma estensione  ".MDF". Per cercare
  192.          le parti simili nei files, MDIFF si serve di una
  193.          stringa base di lunghezza  predefinita detta chunk.  La lunghezza
  194.          del chunk e' per default di  16 byte ma puo' essere  cambiata (in
  195.          un range 4-256) con lo switch -C seguito dalla lunghezza voluta.
  196.          Quando MDIFF  perde  il  sincronismo  tra  i due  files  che  sta
  197.          confrontando, cerca di ritrovarlo scandendo il  vecchio file alla
  198.          ricerca del chunk che sta elaborando. Tale  ricerca viene operata
  199.          in un  intorno dell'ultimo  chunk trovato  in  un range  definito
  200.          dallo switch -R . Per default  tale range e' di 8 blocchi  di 512
  201.          bytes, ma puo' variare tra 1 e 16. Se tale ricerca fallisce MDIFF
  202.          cerca di forzare il sincronismo cercando in un  raggio piu' ampio
  203.          di quello definito: 1/16 della lunghezza del file. Questa seconda
  204.          ricerca  puo'   essere  disabilitata   tramite   lo  switch   -F.
  205.          Specificando lo  switch  -S,  alla  fine  dell'operazione,  MDIFF
  206.          fornira' alcuni dati sulla composizione del file di differenza.
  207.  
  208.  
  209.  
  210.          7.MPATCH - MPATCH2
  211.  
  212.          MDIFF sarebbe  un  programma  inutile se  non  esistesse  MPATCH.
  213.          Infatti MPATCH si occupa, dati <OldFile> e <MDFfile>, di ricreare
  214.          <NewFile>. Vediamo come si usa:
  215.  
  216.                       MPATCH <MDFfile> [<OldFile>] [<NewFile>]
  217.  
  218.          L'unico parametro necessario  e' il nome  del file di  differenza
  219.          <MDFfile> perche' esso contiene i  nomi degli altri due  file, ma
  220.          e'  possibile    modificare  tale  impostazione     semplicemente
  221.          specificando i  nomi  voluti nell'esatto  ordine.  MPATCH non  ha
  222.          nessuno switch o parametro particolare.
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 4 -
  236.  
  237.  
  238.  
  239.  
  240.  
  241.          8.ALCUNI CONSIGLI
  242.  
  243.          Il metodo ottimale  per costruire un  file di differenza  sarebbe
  244.          quello di  ricercare  per tutto  il  vecchio  file i  chunks  che
  245.          compongono il nuovo file;  ovviamente tale metodo sarebbe  di una
  246.          lentezza esasperante. L'algoritmo su cui e' basato MDIFF cerca un
  247.          compromesso tra risultato e  velocita' di esecuzione,  per questo
  248.          e' talvolta opportuno  regolare i  parametri di funzionamento  di
  249.          MDIFF tramite gli  appositi switch.  Vediamo come comportarsi  in
  250.          alcune situazioni tipiche:
  251.          1. File con  pochissime  modifiche:  e'  opportuno  utilizzare un
  252.             chunk molto ampio (32, 64  o piu') in modo  da ridurre il piu'
  253.             possibile le dimensioni del file di differenza.
  254.          2. File di testo: di solito un chunk  di dimensione 32 e' il piu'
  255.             indicato, e'  opportuno  provare  a  togliere  il  sincronismo
  256.             forzato tramite lo switch -F.
  257.          3. File eseguibili  molto  ampi:  spesso  si  ottengono risultati
  258.             migliori  allargando  il  range  di  ricerca  del  sincronismo
  259.             tramite lo switch -R.
  260.  
  261.  
  262.  
  263.          9.DIRITTI
  264.  
  265.          Questo   software   appartiene  alla categoria    dei   programmi
  266.          Shareware: chiunque lo puo' liberamente copiare ed utilizzare per
  267.          un periodo di prova di  15 giorni.  Dopo  tale  periodo, l'utente
  268.          che desideri continuare ad utilizzarlo e' tenuto  a registrare la
  269.          propria copia  inviando  la  quota di  registrazione  all'autore,
  270.          Maurizio Giunti. Gli utenti che pagano la  quota di registrazione
  271.          riceveranno  una  "chiave  di  registrazione"  personale   e  non
  272.          cedibile  che  rendera'   "registrata"  la   propria  copia   del
  273.          programma.
  274.          Chiunque puo' ridistribuire questo software a condizione che  non
  275.          richieda alcuna somma di denaro in cambio, fatta eccezione per le
  276.          spese di  copia  e/o  di  spedizione che,  pero',  devono  essere
  277.          adeguatamente documentate.
  278.          Altra condizione per la libera distribuzione e'  che venga sempre
  279.          fornito per intero  il contenuto  del pacchetto di  distribuzione
  280.          originale,  senza   alcuna  modifica   ai   programmi  e/o   alla
  281.          documentazione.
  282.          Un'unica eccezione: il  programma MPATCH puo'  essere liberamente
  283.          ridistribuito insieme ad uno o piu' files *.MDF  prodotti con una
  284.          copia REGISTRATA di MDIFF.
  285.  
  286.  
  287.  
  288.          10.GARANZIE
  289.  
  290.          L'unica garanzia fornita con questo software e' che occupa spazio
  291.          su  disco.  Non   posso  assolutamente  garantire   che  funzioni
  292.          perfettamente o rappresenti la soluzione di ogni vostro problema.
  293.          Sono inoltre sicuro che  non e' un virus  e non contiene  (a meno
  294.          che non sia stato infettato  o  modificato  dopo la compilazione)
  295.          Trojan-Horses, Back-Doors   o  altre diavolerie  simili. In  ogni
  296.  
  297.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 5 -
  298.  
  299.  
  300.  
  301.  
  302.  
  303.          caso l'autore declina  ogni responsabilita' diretta  o indiretta,
  304.          per eventuali danni morali o materiali derivanti dal suo uso.
  305.  
  306.  
  307.  
  308.          11.LIBRERIE DI CLASSI C++
  309.  
  310.          Nel pacchetto di distribuzione  sono allegate alcune  librerie di
  311.          classi,  per  Dos  e  OS/2  2.xx,  utili  per  realizzare  propri
  312.          programmi per applicare le patch prodotte con MDIFF.
  313.          Tali librerie funzionano  soltanto con  files *.MDF prodotti  con
  314.          COPIE REGISTRATE di MDIFF.
  315.          Il pacchetto contenente le  librerie e' corredato di  un sorgente
  316.          di esempio e di tutta la documentazione necessaria.
  317.  
  318.  
  319.  
  320.          12.COME REGISTRARSI
  321.  
  322.          Il costo della  chiave di  registrazione individuale, valida  sia
  323.          per la  versione  Dos che  per  quella OS/2,  e'  di 15.000  lire
  324.          italiane. Site-license disponibili  a richiesta.  A tale  importo
  325.          deve essere poi aggiunto un contributo per le spese di spedizione
  326.          di lire 1000 per l'Italia o di lire 2000 per  l'Estero. Il codice
  327.          di registrazione sara'  spedito tramite normale  lettera, oppure,
  328.          ma SOLO per l'Italia e  solo SU ESPLICITA RICHIESTA  via TeleFax.
  329.          E' inoltre  possibile richiedere  la spedizione  della chiave  di
  330.          registrazione via e-mail Internet,  in questo caso  il contributo
  331.          per le spese postali non e' richiesto.
  332.          La registrazione puo' essere effettuata in qualsiasi  modo, ma e'
  333.          consigliabile    l'utilizzo  di  vaglia    postale  in  Italia  o
  334.          International Postal Check in Lire Italiane dall'estero, pagabile
  335.          all'ufficio   postale  di  "FIRENZE"  ed  intestato  al  seguente
  336.          nominativo:
  337.  
  338.                                    Maurizio Giunti
  339.                                 Via G.B. Foggini, 24
  340.                                  50142 Firenze (FI)
  341.                                         ITALY
  342.  
  343.          E' importante indicare bene, nel vaglia, il nome del programma da
  344.          registrare, il proprio nome, cognome, indirizzo e numero di FAX o
  345.          indirizzo  e-mail  (se   necessario).  Chi   voglia  fare   delle
  346.          comunicazioni puo'  utilizzare  l'apposito  spazio  sullo  stesso
  347.          vaglia, oppure  puo' spedire  un e-mail  a  "Maurizio Giunti"  ai
  348.          seguenti indirizzi:
  349.  
  350.                                 Fidonet: 2:332/102.3
  351.  
  352.                           Internet: Giunti@stat.ds.unifi.it
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 6 -
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.          13.RINGRAZIAMENTI
  368.  
  369.          Vorrei brevemente  ringraziare  gli amici  che  mi hanno  aiutato
  370.          nello  sviluppo  di   questo  software  e   della  documentazione
  371.          allegata, o  che  si  sono  coraggiosamente  offerti  come  beta-
  372.          testers. In ordine alfabetico:
  373.  
  374.  
  375.                                    Andrea Baitelli
  376.  
  377.                                     Silvia Borri
  378.  
  379.                                     Filippo Dini
  380.  
  381.                                  Fabrizio Fioravanti
  382.  
  383.                                  Cristiano Guidoccio
  384.  
  385.                                 Giovanni Lopes Pegna
  386.  
  387.                                   Marco Maccaferri
  388.  
  389.                                    Giuseppe Scarpi
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 7 -